Rust Korea Hub

1.2 개발 환경 구축 (Getting Started)

이 섹션에서는 Dioxus 앱을 개발하기 위해 필요한 에디터, Rust 툴체인, Dioxus CLI(dx), 그리고 운영체제별 시스템 의존성을 설치하는 방법을 다룹니다. Dioxus는 자체 빌드 도구인 dx를 통해 핫 리로딩, 번들링, 웹/모바일 개발 서버를 통합 제공하므로, 이 단계를 확실히 마치는 것이后� 학습의 기초가 됩니다.

에디터 선택

공식적으로 VSCode를 추천합니다. Dioxus 전용 VSCode 확장이 제공되어 RSX 문법 강조, 코드 폴딩, HTML↔RSX 변환 등을 지원합니다. 빌드 도구 dx는 터미널에서 사용합니다. 또한 대부분의 에디터에서 Rust-Analyzer LSP 플러그인을 지원하므로, VSCode 외에 Zed, Emacs, Vim 등을 사용해도 됩니다.

Rust 설치

Rust 공식 웹사이트에서 rustup을 사용해 Rust 컴파일러를 설치합니다. 설치 후 안정(stable) 툴체인과 웹 앱용 WASM 타겟을 추가합니다. Dioxus 공식 문서는 “Rust 책(The Book)“을 처음부터 끝까지 읽어볼 것“을 권장하지만, Dioxus 앱 자체가 훌륭한 첫 Rust 프로젝트가 될 수 있습니다. async·수명(lifetime)·스마트 포인터 같은 심화 개념은 복잡한 앱을 만들기 전까지는 깊이 몰라도 됩니다.

# 안정 버전 툴체인 설치

rustup toolchain install stable
# 웹(WASM) 타겟 추가 - Dioxus 웹 앱을 빌드하려면 필수
rustup target add wasm32-unknown-unknown

Dioxus CLI (dx) 설치

dx는 cargo를 기반으로 핫 리로딩, 번들링, 웹·모바일 개발 서버를 제공하는 통합 빌드 도구입니다. 미리 빌드된 바이너리를 설치하는 것이 가장 빠릅니다.

# 방법 1 (권장): 공식 설치 스크립트로 미리 빌드된 바이너리 다운로드
curl -sSL [https://dioxus.dev/install.sh](https://dioxus.dev/install.sh) | bash

# 방법 2: cargo-binstall 사용 (미리 빌드된 바이너리)
cargo binstall dioxus-cli --force
# 방법 3: 소스에서 빌드 (최대 10분 소요, 의존성 多)
cargo install dioxus-cli

플랫폼별 의존성

macOS

별도 의존성 없이 그대로 사용 가능합니다. iOS 앱을 빌드하려면 아래 iOS 섹션을 참고하세요.

Windows

WebView2 라이브러리가 필요합니다. 최신 Windows에는 기본 탑재되어 있고, Edge가 설치되어 있다면 Dioxus도 잘 동작합니다. WebView2가 없다면 [Microsoft 다운로드 페이지] (https://developer.microsoft.com/en-us/microsoft-edge/webview2/)에서 3가지 옵션 중 선택할 수 있습니다.

권장은 Option 1(작은 “evergreen” 부트스트래퍼).

Linux (Ubuntu)

WebKitGTK와 xdotool이 필요합니다. 배포 시 .rpm 또는 .deb 의존성 트리에 포함되어야 합니다.

sudo apt update 
sudo apt install libwebkit2gtk-4.1-dev \ 
build-essential \ 
curl \ 
wget \ 
file \ 
libxdo-dev \ 
libssl-dev \ 
libayatana-appindicator3-dev \ 
librsvg2-dev \ 
lld

Linux (Arch)

sudo pacman -Syu 
sudo pacman -S --needed \ 
webkit2gtk-4.1 \ 
base-devel \ 
curl \ 
wget \ 
file \ 
openssl \ 
appmenu-gtk-module \ 
libappindicator-gtk3 \ 
librsvg \ 
xdotool

Linux (Fedora)

sudo dnf install libxdo-devel

WSL (Windows Subsystem for Linux)

가능하긴 하지만 까다롭습니다. 일부 기능이 동작하지 않을 수 있습니다. 권장 단계:

WSL 커널을 최신으로 업데이트하고 WSL 2로 전환
~/.zshrc에 export DISPLAY=:0 추가
Tauri의 Linux 의존성 설치
파일 대화상자(file dialog)를 위해 zenity 같은 폴백 설치
libEGL 경고가 뜰 수 있지만 앱은 정상 렌더링됩니다

iOS

macOS가 설치된 기기와 XCode가 필요합니다. XCode는 Mac App Store 또는 Apple Developer 웹사이트에서 다운로드할 수 있으며, iOS SDK와 시뮬레이터도 추가로 설치해야 합니다.

Android

Android SDK와 NDK 설치가 필요합니다. 설정이 상당히 복잡하므로 [전용 모바일 가이드]

(https://dioxuslabs.com/learn/0.7/guides/platforms/mobile)를 참고하세요.

dx doctor 명령
dx doctor 명령을 실행하면 dx가 여러분의 설치 환경을 점검하고, 빠진 툴체인이나 도구가 무엇인지 알려줍니다.

환경 구축이 끝난 뒤 한 번 실행해 보는 것을 권장합니다.

핵심 포인트

Rust + dx CLI + (플랫폼별) 시스템 라이브러리가 필요
rustup target add wasm32-unknown-unknown으로 웹 타겟 추가
curl -sSL https://dioxus.dev/install.sh | bash가 가장 빠른 dx 설치법
dx doctor로 환경 검증